home *** CD-ROM | disk | FTP | other *** search
/ Resource Library: Multimedia / Resource Library: Multimedia.iso / utils / sound / players / amiga / stp / stp.dts < prev    next >
Encoding:
Text File  |  1993-01-11  |  13.9 KB  |  409 lines
  1. ******************************************************************************
  2. ***                                       ***
  3. ***                        D.E.R. ST-Player V1.23               ***
  4. ***                                       ***
  5. ******************************************************************************
  6. ***                                       ***
  7. ***                                       ***
  8. ***    implementiert von:   Wolfgang BREYHA                   ***
  9. ***                Gro▀er Ring 42                   ***
  10. ***                1130  Wien                       ***
  11. ***                ╓sterreich                       ***
  12. ***                                       ***
  13. ***                                       ***
  14. ******************************************************************************
  15. ***                                       ***
  16. ***    Das Programm ist FREEWARE und darf frei vertrieben werden wenn:       ***
  17. ***                                       ***
  18. ***    - Das Programm, sein Piktogramm und die Dokument-Files            ***
  19. ***      immer gemeinsam weitergegeben werden                   ***
  20. ***    - Keine VerΣnderungen an dem gesamten Paket vorgenommen werden,    ***
  21. ***      ausser mit meiner ausdrⁿcklichen Genehmigung               ***
  22. ***                                       ***
  23. ***                                       ***
  24. ******************************************************************************
  25. ***                                       ***
  26. ***                                       ***
  27. ***    Du findest mich bei: D.E.R. Computer-Club               ***
  28. ***                Stiegerg. 5/1                   ***
  29. ***                1150  Wien                       ***
  30. ***                ╓sterreich                       ***
  31. ***                Montag und Donnerstag, 17-20 Uhr           ***
  32. ***                                       ***
  33. ******************************************************************************
  34.  
  35. Bevor Ihr den STP benutzt leiht mir bitte eure Ohren:
  36. -----------------------------------------------------
  37.  
  38. Ich arbeite jetzt nahezu 2╜ Jahre an diesem Werk und das Ergebnis kann sich
  39. glaube ich sehen lassen. So hΣtte ich die kleine Bitte, da▀ Ihr es mich
  40. wissen lΣ▀t, wenn Ihr einen Fehler entdeckt! (Fⁿr VerbesserungsvorschlΣge
  41. bin ich auch sehr dankbar!!) Ich bin nicht geil auf's Geld und habe das 
  42. Programm fⁿr meinen eigenen Gebrauch geschrieben, aber bitte helft mir ein
  43. klein wenig bei der Fehlerkorrektur.
  44.  
  45. Wer das Programm jedoch so gut findet, da▀ er(sie) mir unbedingt Geld
  46. schicken m÷chte, soll das nur tun. Wie viel ist mir eigentlich egal!
  47. Vielleicht bin ich der erste Freeware-Coder der damit Millionen verdient!
  48. Wer mir dabei helfen m÷chte soll sie nur schicken (die Millionen)!!
  49.  
  50. Wenn Ihr Probleme mit einem bestimmten Modul habt, dann schickt es mir bitte
  51. auf einer Diskette! Ihr bekommt eine neue Version von STP retour!
  52.  
  53. Nach ein paar Tests auf einem A3000 sollten auch die Probleme mit dem Caching
  54. und den anderen Features von Turbokarten behoben sein.
  55.  
  56. Au▀erdem habe ich jetzt auch schon einen 2000'er mit A2630 und er lΣuft und
  57. lΣuft und lΣuft.
  58.  
  59.  
  60. ben÷tigte Hardware:
  61. -------------------
  62.  
  63. Irgendein Amiga, mit zumindest Kick 1.2 und einen super StereoverstΣrker!!!!
  64.  
  65. ben÷tigte Software:
  66. -------------------
  67.  
  68. viele Soundtrackermodule!!
  69. Wenn jemand MachIII verwendet, soll er bitte das Kapitel
  70. 'taktische Tips bei der Benⁿtzung des STP' lesen!!!
  71.  
  72. Kurzbeschreibung:
  73. -----------------
  74.  
  75. D.E.R. ST-Player ist ein Soundtracker-Moduleplayer mit einigen SpezialitΣten!
  76.  
  77. - 'Fire and Forget'-System (ErklΣrung spΣter)
  78. - ein super Channel-Analyser!
  79. - kompakter Code (100% Assembler)
  80. - STP funktioniert auf 680x0-Turbokarten!
  81. - STP spielt Soundtracker V2.0-V2.6, Noisetracker V1.0-V2.0 und
  82.          Protracker  -V1.1B Module
  83. - Ist der Screen im Hintergrund braucht STP keine CPU-Zeit!
  84.   (Abspielroutine ausgenommen)
  85. - erweiterte Filterkontrollm÷glichkeiten
  86. - Position- und Notenkontrolle
  87. - LautstΣrkeregler
  88. - NonStop Funktion
  89. - programmierbar
  90. - kann PowerPacker-(PP20) und FileImploder-files entpacken!!
  91.   seit V1.22 auch XPK-Files
  92. - CLI- und WORKBENCH-Start voll unterstⁿtzt!!
  93. - Kick 2.0 konform (ASL-Request, ScreenTags)
  94. - (FOR EXPERIENCED USERS ONLY!!: Player is able to run objectmodules!!)
  95.  
  96.  
  97. Anleitung:
  98. ==========
  99.  
  100. CLI-Start:
  101. ----------
  102.  
  103. STP [DIR-Name | Module-Name] [-m] [-sxxx] [-r] [-n] [-j] [-a] [-d] [?]
  104.  
  105. Wenn D.E.R.STP-Player ohne Optionen gestartet wird, benutzt er folgende
  106. Vorgabewerte:
  107.  
  108. - STP sucht das File ENV:PlayerDir. Steht in diesem File ein gⁿltiger Pfad
  109.   , so sucht STP die Module in diesem.
  110. - ansonsten wird der Pfad 'ST-00:modules' verwendet.
  111. - STP nimmt alles an Speicher was er bekommt oder braucht.
  112. - STP spielt die Module alphabetisch (A-Z) sortiert
  113. - STP spielt alle Files die irgendwie nach ST-Modul riechen.
  114. - STP ladet das nΣchste Lied, wenn das derzeit gespielte Lied zu Ende ist.
  115. - das 'B'-Kommando (Position-Jmp) vom ST wird ausgefⁿhrt
  116.  
  117. Optionen:
  118.    ?    -> zeigt das Hilfefenster
  119.  
  120.   -m    -> STP findet nur Files die mit 'mod.' beginnen.
  121.  
  122.   -sxxx -> STP reserviert sich maximal xxx KByte Speicher fⁿr die Module.
  123.        Gr÷▀ere Module werden dadurch nicht in die Liste aufgenommen.
  124.        (Diese Option stammt noch aus der 512KB-Chip-Zeit. Lang, lang ist's
  125.        her. Aber angeblich gibt's noch solche AMIGA's!?!?)
  126.  
  127.   -r    -> STP spielt die Module in zufΣlliger Reihenfolge (wie RANDOM- od. 
  128.        SHUFFLE-Taste auf CD-Player)
  129.  
  130.   -j    -> schaltet das Position-Jmp-Kommando des ST ab.
  131.        (dient zur Unterbindung von Endlosschleifen)
  132.  
  133.   -n    -> STP versucht das nΣchste Lied zu laden, wenn das derzeit gespielte
  134.        knapp vor seinem Ende ist (3 Patterns). Dadurch entstehen keine
  135.        Pausen zwischen den Liedern! (Funktioniert nur, wenn genug
  136.        FAST-Mem frei ist!)
  137.  
  138.   -d    -> Stellt den Mode-Knopf am Analyser auf ON (Wirkung wird spΣter
  139.        erklΣrt).
  140.  
  141. seit V1.1:
  142.   -f    -> schaltet Auto-Fade ein (ErklΣrung spΣter)
  143.  
  144. Man kann den STP auch mit einem Modulnamen anstatt einem Verzeichnis starten.
  145. In diesem Fall wird automatisch der REPEAT-Modus eingeschaltet und die |<, >|
  146. Tasten haben keinerlei Wirkung.
  147.  
  148. Start ⁿber die Workbench:
  149. -------------------------
  150.  
  151. folgende TOOLTYPES werden unterstⁿtzt:
  152.  
  153.  
  154. SONGDIR={Pfad}
  155. RANDOM     -> ON/(OFF);        z.B.:'RANDOM=ON';
  156. ANALYZER -> (ON)/OFF;
  157. NONSTOP  -> ON/(OFF);
  158. NOPOSJMP -> ON/(OFF);
  159. MODONLY  -> ON/(OFF);
  160.  
  161. MAXCHIP=xxx: STP darf nicht mehr als xxx KByte Chipmem verwenden
  162.          z.B.:'MAXCHIP=200'
  163.  
  164. seit V1.1:
  165. AUTOFADE -> ON/(OFF);
  166.  
  167.  
  168.  
  169. Wenn der STP dann endlich lΣuft:
  170. --------------------------------
  171.  
  172. Wenn kein ENV:-File und kein Verziechnisnamen gefunden wurde, mⁿssen Sie
  173. den STP erst einmal einschalten und ein Verzeichnis eingeben (Unter Kick 2.0
  174. per ASL-Request)! Danach lie▀t er einmal das Verzeichnis ein!
  175.  
  176. Dann ladet er das erste Modul ('loading Song...').
  177.  
  178. Nun sollte er fⁿr gew÷hnlich zum Spielen beginnen!!
  179.  
  180. Ab jetzt stehen ihnen alle Schalter, Schieber und Tasten zur freien
  181. Verfⁿgung. Sie haben alle eine Funktion. Welche, m÷chte ich nun erklΣren:
  182.  
  183. LautstΣrke-Schieber: (Volume)
  184. -----------------------------
  185. Einfach mit der Maus anklicken, Maustaste halten und herumfahren...
  186. Mehr brauch ich wohl nicht mehr sagen!?!?
  187.  
  188. Filter-Schalter:
  189. ----------------
  190. Ich gebe schon zu, da▀ die Schrift auf dem STP nicht gerade gut zu lesen ist.
  191. Deshalb m÷chte ich immer die Position der gerade besprochenen Schalter und 
  192. Tasten auf dem Player beschreiben.
  193.  
  194. Die Filter-Schalter befinden sich rechts neben dem LautstΣrke-Schieber.
  195.  
  196.            On     Auto    <- Wenn Knopf gedrⁿckt
  197.    Knopf    -> ++   ||    ++    <- Knopf
  198.            Off      Manual  <- Wenn Knopf nicht gedrⁿckt
  199.             ^
  200.            Licht
  201.  
  202. Befindet sich der rechte Knopf in der 'Manual'-Position, dann wird das 'E'-
  203. Kommando des ST (Set Filter) ignoriert (aber intern gespeichert) und man
  204. kann das Filter mit dem linken Schalter ein und aus schalten.
  205.  
  206. Befindet sich der rechte Knopf dagegen in der 'Auto'-Position, dann wird das
  207. Filter von dem Modul selber (mittels des 'E'-Kommandos) gesteuert.
  208.  
  209. Position- und Note-Taster:
  210. --------------------------
  211. Unter dem Display befinden sich zwei Paare von <, > Tastern.
  212. Mit dem linken Paar steuert man die Position mit dem rechten die Note.
  213. (Position und Note sind Begriffe vom SoundTracker die von mir 
  214. ⁿbernommen wurden)
  215.  
  216. Liedersteuerung:
  217. ----------------
  218. Am rechten Rand des Players sehen sie vier Taster
  219. |<,>|    : Lade das vorige bzw. nΣchste Lied.
  220. Stop    : Stoppt das Lied. Nur dann kann man die 'Open'-Taste benutzen
  221. Play    : wechselt zwischen Pause und Play
  222.  
  223. Unter dem Display sind noch einige Taster:
  224.  
  225. RepS    : Schaltet die Wiederholfunktion ein. REPEAT erscheint im Display
  226.       Das derzeit gespielte Lied wird so lange wiederholt, bis
  227.       RepS erneut gedrⁿckt wird.
  228. Select    : Drⁿcken sie einfach einmal drauf. Nun sehen sie ein '>' vor
  229.       dem Liednamen im Display. Nun kann man mit den |<, >|-Tasten
  230.       die Liedernamen durchsuchen, ohne sie gleich zu laden.
  231.       Hat man ein anderes Lied gefunden drⁿcken sie auf die Play-Taste
  232.       und das Lied wird geladen. Wollen sie das derzeitige Lied weiter-
  233.       h÷ren, drⁿcken sie entweder Stop oder nochmals Select und der STP
  234.       tut als wΣre nichts gewesen.
  235.  
  236. Programmierung des Players:
  237. ---------------------------
  238.  
  239. Drⁿcken Sie die 'Prog'-Taste.
  240. 'Program' wird nun im Display angezeigt!
  241. WΣhlen Sie mit den |<, >|-Tasten ein Lied aus.
  242. Nun drⁿcken Sie abermals 'Prog'.
  243. Es erscheint eine Nummer (z.B.:'01') und ein 'P' in der Anzeige.
  244. Die Nummern die hier verteilt werden stellen die Reihenfolge beim Abspielen dar
  245. Wenn Sie 'Prog' nochmal drⁿcken erscheint ein 'C' in der Anzeige, was heissen
  246. soll, da▀ das Lied wieder gel÷scht wurde.
  247. Programmieren sie auf diese Art alle Lieder die Sie h÷ren wollen.
  248. Dann drⁿcken Sie 'Play' um das Programm auszufⁿhren.
  249.  
  250. Folgende M÷glichkeiten haben Sie noch zusΣtzlich wΣhrend dem Programmieren:
  251.  
  252. 'Select'  : Programmiert alle Lieder auf einmal
  253.         Danach k÷nnen Sie z.B. die Lieder die Sie nicht h÷ren wollen
  254.         wieder l÷schen.
  255. 'Random'  : Verteilt die Reihenfolge unter den bisher programmierten Liedern
  256.         neu.
  257. 'Stop'      : l÷scht das Programm und kehrt in den normalen Modus zurⁿck
  258.  
  259.  
  260. Random (V1.1)
  261. -------------
  262. Die Random-Taste funktioniert jetzt auch im normalen Modus.
  263. Drⁿcken Sie die RANDOM-Taste und eine zufΣllige Reihenfolge wird erzeugt.
  264. 'Program' erscheint im Display.
  265.  
  266. Auto-Fade (V1.1)
  267. ----------------
  268. Ist die Taste gedrⁿckt Fadet der Player die LautstΣrke am Ende jedes Liedes
  269. langsam aus.
  270.  
  271.  
  272.  
  273. Wie wechselt man das Verzeichnis:
  274. ---------------------------------
  275. Drⁿcken Sie zuerst die 'Stop'-Taste und dann 'Open'.
  276. Nun ÷ffnet sich ein Fenster in dem sie den neuen Pfad eingeben k÷nnen.
  277.  
  278. V1.1: Wenn sie glⁿcklicher Besitzer einer Kickstart V2.0 oder h÷her sind,
  279.       k÷nnen sie den neuen Pfad mittels ASL-Requester bestimmen.
  280.  
  281.  
  282.  
  283.  
  284. Der Analyser:
  285. -------------
  286. Er hat vier Schalter
  287.  
  288.    ++    <- Mode
  289.  
  290.    ++    <- Analyser On/Off
  291.  
  292.    ++    <- VU-Meter On/off
  293.  
  294.   ++++    <- Ein-/Ausschalter
  295.  
  296.  
  297. Mode:    Schaltet zwischen zwei Berechnungsmethoden um
  298.  
  299.     Schalter nicht gedrⁿckt:
  300.         Hohe Frequenzen werden besser sichtbar
  301.  
  302.     Schalter gedrⁿckt:
  303.         Tiefe Frequenzen werden besser sichtbar
  304.  
  305.  
  306.  
  307.  
  308. Information fⁿr Musiker:
  309. ------------------------
  310.  
  311. Ich habe das Informationssystem vom Intuitracker ⁿbernommen!!
  312. Damit kann man die Samplenamen fⁿr Mitteilungen verwenden!!
  313. Jeder Samplenamen der mit '#' beginnt wird im Display angezeigt.
  314. Ich zeige noch vor dem ersten Sample den Schriftzug 'composed by '
  315. also erwarte ich mir von euch als erste Mitteilung euren Namen!!
  316.  
  317.  
  318. Taktische Tips im Umgang mit Player:
  319. ------------------------------------
  320.  
  321. STP testet jedes File ob es ⁿberhaupt ein Modul ist.
  322. Da es aber keinen 100%igen Standart gibt (eigentlich gibt es gar keinen)
  323. ist es natⁿrlich m÷glich (0.0001%), da▀ sich meine Testroutine irrt und 
  324. der Player versucht dieses File zu spielen. In diesem Fall wⁿrde ich 
  325. dringend anraten dieses File aus dem Verzeichnis zu entfernen, da es sonst
  326. zu Abstⁿrzen kommen k÷nnte (und nach Murphy's Gesetz auch sicher kommt).
  327.  
  328. Wenn sie Module die mit dem Powerpacker gepackt wurden verwenden, mⁿssen sie
  329. die 'powerpacker.library' in ihrem LIBS:-Verzeichnis haben.
  330.  
  331. Bei 512KB-Chip Maschinen wⁿrde ich die Option -s200 bzw. MAXCHIP=200 anraten.
  332.  
  333. Der STP reserviert sich immer den Speicher den er fⁿr das lΣngste Lied in dem
  334. Verzeichnis ben÷tigt. Wⁿrde ich jedesmal den Speicher freigeben und neu
  335. reservieren wenn ein neues Lied geladen wird, wΣre der Speicher in kⁿrzester
  336. Zeit derart fragmentiert, da▀ kein Platz mehr fⁿr das nΣchste Lied ist.
  337.  
  338. Wenn Sie das Programm MachIII V3.0 verwenden besorgen sie sich dringend 
  339. zumindest die Version 3.1. Sonst stⁿrzt Ihr Rechner immer ab wenn Sie
  340. den Player starten. (Liegt nicht an mir!!)
  341.  
  342. Der STP ben÷tigt bei eingeschaltenem Analyser ziemlich viel Rechnerzeit im
  343. Vertical-Blank-Interupt. Es wΣre m÷glich das es zu Problemen kommt, wenn
  344. noch andere Programme laufen die ebenfalls viel VB-Zeit verbraten.
  345. (Aber da mir noch keine solchen Programme bekannt sind, vergessen Sie das
  346. einfach wieder!!)
  347.  
  348.  
  349.  
  350. Wie startet man Object-Module:
  351. ------------------------------
  352. Wenn Sie wirklich wissen wollen wie sie mit dem Player Object-Module starten
  353. k÷nnen, dann lernen Sie zuerst Englisch und wenn Sie es k÷nnen lesen sie
  354. die englische Anleitung.
  355.  
  356.  
  357.  
  358.  
  359. Informationen ⁿber das Programm:
  360. --------------------------------
  361. Begin der Codierung:    April 1990
  362. Sourcecode:        130kB - reiner Assembler-Source (~6500 Zeilen)
  363. ObjectCode:         32kB
  364. Assembler:        ASM-One (vorher Masterseka 1.80)
  365. GFX:             45kB - 3 Planes,Hires(640*170) von mir gezeichnet
  366.  
  367.  
  368. Warnungen:
  369. ----------
  370.  
  371. Ich gebe keinerlei Garantie fⁿr die Benⁿtzung des Players.
  372. Sowohl Abstⁿrze als auch Datenverluste k÷nnen nie ausgeschlossen werden.
  373. Jeder benutzt mein Programm 'D.E.R.ST-Player' auf eigene Gefahr.
  374.  
  375.  
  376. Player selber liest die Daten nur von der Platte und kann daher keine Daten-
  377. verluste auf Ihren Disketten oder Festplatten verursachen (dafⁿr aber im RAM!!)
  378. Au▀erdem ist der AMIGA ein Multitasking-Rechner. Daher kann nie ausgeschlossen
  379. werden, da▀ ein anderes Programm auf die Platte zugreift wΣhrend mein armer
  380. kleiner Player gerade aus allen Fugen kracht und Ihr AMIGA sie mit 
  381. 'Liebesgrⁿ▀en aus Indien' beglⁿckt wΣhrend er mit anschwellender R÷te
  382. im Gesicht meditiert.
  383.  
  384. Ich m÷chte aber anmerken, da▀ einige Freunde von mir den Player oft und lang
  385. einsetzen und das in Kombination mit diversesten anderen Programmen und mit
  386. den diversesten Konfigurationen (A500, A2000, div. HD's, etc).
  387. Und Sie hatten noch keinerlei Probleme mit Datenverlusten oder dubiosen
  388. Abstⁿrzen.
  389.  
  390.  
  391. Zum Schlu▀ noch vielen Dank an
  392.  
  393.         Michael Matzl, Reinhard Franz,
  394.         Erwin Kloibhofer, Dieter Henkel,
  395.         und einige Mitglieder des D.E.R. Computerclubs
  396.  
  397. fⁿr das Testen, die Fehlerberichte, einige gute Ideen und beste Freundschaft.
  398.  
  399. Kantaktm÷glichkeiten:
  400. ---------------------
  401.  
  402. schreibe an:    Wolfgang BREYHA
  403.         Gro▀er Ring 42
  404.         1130  WIEN
  405.         ╓sterreich
  406.  
  407. E-Mail:        ookummer@swwwnext.tuwien.ac.at
  408.  
  409.